Mobile Document Viewer help

Introduction

Mobile Document Viewer is a document viewing application for Android-based devices. It allows opening office productivity application documents located in the filesystem, e.g. on sd card, as well downloaded documents, or documents files attached to an email.

The following file formats are currently supported:

OpenOffice.org 2.x and 3.x formats: .odt (Writer), .ods (Calc), .odp (Impress)
OpenOffice.org 1.x formats: .sxw (Writer), .sxc (Impress)
Microsoft Office 2007 formats (experimental): .docx (Word), .xlsx (Excel), .pptx (Powerpoint)
Other formats: .txt (plain text), .csv (comma-separated values)

Please note that some restrictions apply for viewing documents:

Displaying the document is done via a conversion to HTML, which is why the document will look differently than if viewed with a desktop office productivity application.
Large files will take very long to open, or sometimes not open at all.
When displaying images, only those images will be shown where the image format is supported by the Android browser.
Password-protected documents cannot be opened.

The main screen

When opening the Mobile Document Viewer application, you will be presented a screen containing a list of documents found on your SD card. Clicking on one of the files will open it for viewing.
You will also find buttons for

showing this help page,
editing the application settings,
exiting the application.

These options are also available as menu items.

Application settings

Maximum columns to decode: In order to improve the decoding speed, the number of columns inside ODF document tables is limited to 100 columns. Use this setting to increase this default and show more columns.
Use system monospace font: Check this option to use the device's monospace font instead of the ones that might be defined in the document.
Full Screen Mode: Check this option in order to view documents in full screen mode, hiding the system's notification and title bar, in order to gain more space for the document.
File browser mode: The default setting for the file browser is to automatically search the complete SD card for documents with the supported formats. By selecting "manual" mode you can disable this and search for the documents manually.
Show buttons: Determines whether the buttons below the document view always get displayed, never get displayed or get displayed automatically depending on the screen rotation (portrait mode = on, landscape mode = off).

Using the viewer component

A file picked from the file picker is opened in the viewer component. The document gets converted to HTML and automatically displayed using the Android browser view. The conversion will take some time, depending on the size and type of the document. During this time a progress bar will be visible.
Using the up- and down- buttons on the top right of the screen, you can scroll through the document. Moving your finger over the touchscreen also allows you to move through the document.
Also on the top right of the screen you can find a magnifying glass icon and a de-magnifying glass icon. These icons allow you to change the zooming of the document. The magnifying glass allows you to see an enlarged version of the document.
Corresponding menu items for all buttons can be found in the main menu.
If your device support text-to-speech output for the current document's language and the document is a .odt, .sxw or .docx document, then you can have your device read the document to you via the 'Read Aloud' menu item. Using a small dialog the playback can be controlled.
If data for the text-to-speech voices is missing, then a menu item 'Install text-to-speech data' will appear. In order to afterwards use the text-to-speech functionality for the current document you have to close and re-open the document.

Keyboard shortcuts

Menu + h = Help
Menu + j = Back (if a hyperlink was clicked)
Menu + k = Forward (if a hyperlink was clicked)
Menu + i = Zoom In
Menu + o = Zoom Out

Miscellaneous

License for the included Jsoup HTML parser:

Copyright (c) 2009, 2010 Jonathan Hedley (jonathan@hedley.net)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.